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NAME 

IO::Pty - Pseudo TTY object class 

VERSION 

1.08 

SYNOPSIS 

use 10::Pty; 

$ptY = new I0::PtY; 

$slave = $ptY“>slave; 

foreach $val (1..10) { 

print $ptY "$val\n"; 

$_ = <$slave>; 
print 

} 

close($slave); 

DESCRIPTION 

10: : Pty provides an interface to allow the creation of a pseudo tty. 

10: :PtY inherits from 10: : Handle and so provide all the methods defined by the 10: : Handle 
package. 

Please note that pty creation is very system-dependend. If you have problems, see IO::Tty for help. 

CONSTRUCTOR 

new 

The new constructor takes no arguments and returns a new file object which is the master side of the 
pseudo tty. 

METHODS 

ttynameO 

Returns the name of the slave pseudo tty. On UNIX machines this will be the pathname of the device. 
Use this name for informational purpose only, to get a slave filehandle, use slave(). 

slaveO 

The slave method will return the slave filehandle of fhe given master pty, opening it anew if 
necessary. If IO::Stty is installed, you can then call $slave->stty () to modify the terminal 
settings. 

close_slave() 

The slave filehandle will be closed and destroyed. This is necessary in the parent after forking to get 
rid of the open filehandle, ofherwise fhe parenf will nol notice if the child exits. Subsequent calls of 
slave () will return a newly opened slave filehandle. 

make_slave_controlling_terminal() 

This will sef the slave filehandle as the controlling terminal of the current process, which will become 
a session leader, so this should only be called by a child process after a fork(), e.g. in the callback to 
sync_exec () (see Proc::SyncExec). See the try script (also test .pi) for an example how to 
correctly spawn a subprocess. 

set_raw() 

Will set the pty to raw. Note that this is a one-way operation, you need IO::Stty to set the terminal 
settings to anything else. 

On some systems, the master pty is not a tty. This method checks for that and returns success anyway 
on such systems. Note that this method must be called on the slave, and probably should be called on 
the master, just to be sure, i.e. 
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$pty->slave->set_raw(); 

$pty->set_raw(); 

clone_winsize_from(\*FH) 

Gets the terminal size from filehandle FH (which must be a terminal) and transfers it to the pty. 
Returns true on success and undef on failure. Note that this must be called upon the slave, i.e. 

$pty->slave->clone_winsize_from( \*STDIN); 

On some systems, the master pty also isatty. I actually have no idea if setting terminal sizes there is 
passed through to the slave, so if this method is called for a master that is not a tty, it silently returns 
OK. 

See the t ry script for example code how to propagate SIGWINCFl. 

SEE ALSO 

IO::Tty, IO::Tty"Constant, IO::Handle, Expect, Proc::SyncExec 

MAILING LISTS 

As this module is mainly used by Expect, support for it is available via the two Expect mailing lists, 
expectperl-announce and expectperl-discuss, at 

http://lists.sourceforge.net/lists/listinfo/expectperl-announce 
and 

http://lists.sourceforge.net/lists/listinfo/expectperl-discuss 

AUTHORS 

Originally by Graham Barr <gbarr@pobox.com>, based on the Ptty module by Nick Ing-Simmons 
<nik@tiuk. ti.com>. 

Now maintained and heavily rewritten by Roland Giersig <RGiersig@cpan.org>. 

Contains copyrighted stuff from openssh v3.0pl, authored by Tatu Ylonen <ylo@cs.hut.fi>, Markus Friedl 
and Todd C. Miller <Todd.Miller@courtesan.com>. 

COPYRIGHT 

Now all code is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 

Nevertheless the above AUTHORS retain their copyrights to the various parts and want to receive credit if 
their source code is used. See the source for details. 

DISCLAIMER 

THIS SOFTWARE IS PROVIDED “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, 
BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OE MERCHANTABILITY AND EITNESS EOR A 
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE EOR ANY 
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OE SUBSTITUTE GOODS OR SERVICES; LOSS OF 
USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 
OTHERWISE) ARISING IN ANY WAY OUT OE THE USE OE THIS SOFTWARE, EVEN IE ADVISED OF THE 
POSSIBILITY OP SUCH DAMAGE. 

In other words: Use at your own risk. Provided as is. Your mileage may vary. Read the source, Luke! 

And finally, just to be sure: 

Any Use of This Product, in Any Manner Whatsoever, Will Increase the Amount of Disorder in the 
Universe. Although No Liability Is Implied Herein, the Consumer Is Warned That This Process Will 
Ultimately Lead to the Heat Death of the Universe. 
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